开票状态回传 | 商户->百度
更新时间:2024-01-18
开票状态回传【百度即时请求商户】
接口地址
线下:http://test.carowner.baidu.com/map_mc/preorder/callbackinvoice
线上:https://maphotel.baidu.com/map_mc/preorder/callbackinvoice
接口描述
回传用户开发票信息
权限说明
为确保对内外请求安全性,添加公共参数并对公共参数进行统一验签,对于百度请求商户,百度在请求参数中添加以下公共参数,对于商户数据推送百度,在推送json数据体最外层key中也添加以下公共参数(详细见各推送数据样例)。
字段名 | 类型 | 长度 | 必填 | 释义 | |
---|---|---|---|---|---|
1 | tp_name | string | 64 | 是 | 渠道号,开发前分配渠道号和私(primary_key),请妥善保管 |
2 | timestamp | int | 10 | 是 | 秒时间戳 |
3 | salt | string | 64 | 是 | 随机串 |
4 | sign | string | 64 | 是 | 签名,签名规则 md5(tp_name + timestamp + salt + primary_key),单纯参数值(不含参数名)拼接,不需要加入参数名 |
请求参数
字段名 | 类型 | 长度 | 必填 | 释义 | |
---|---|---|---|---|---|
1 | bd_pre_order_id | string | 64 | 是 | 百度预支付单号 |
2 | bd_pay_order_id | string | 64 | 是 | 百度支付单号 |
3 | tp_order_id | string | 64 | 是 | 供应商单号 |
4 | invoice_status | string | 64 | 是 | 开票状态 1:开票成功 2:开票失败 3:已邮寄 |
5 | invoice_img_link | string | 64 | 否 | 发票图片 |
6 | extra | jsonstring | 64 | 否 | 扩展字段 |
7 | 公共参数 | - | - | 是 | 公共参数参考公共参数部分 |
响应参数
字段名称 | 字段说明 | 字段要求 | 字段类型 | 长度 | |
---|---|---|---|---|---|
1 | errno | 错误码 | 0,success | string | - |
2 | msg | 错误描述 | 0,success | string | - |
3 | data | 详情信息 | string | - |
请求示例
{
"tp_name":"test",
"timestamp":1704943679,
"salt":"2jk3",
"sign":"111"
"bd_pay_order_id":"test_123456", // 百度支付单号
"tp_order_id":"123456",// 供应商单号
"invoice_status":1, // 发票状态
"invoice_img_link":"http://" // 图片地址
"extra":{
"invoice_fail_reason":"xxx", // 开票失败原因
}
}
响应示例
正常
{"errno":0,"msg":"success","data":""}